/*
 * Copyright 2010 Francisco Modesto
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package com.googlecode.gwt.tinyaop.client;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Indicates how a methods annotated by a subtype of this annotation are to
 * be intercepted.<br>
 * The given provider will be instantiated during construction time of the
 * intercepted class, requires 0 args visible constructor.<br>
 * The providers are shared for all the methods in the class.<br>
 * <pre>
 *{@code @Retention}(RetentionPolicy.RUNTIME)
 *{@code @Target}(ElementType.Method)
 *{@code @WithProvider}(MyProvider.class)
 * public{@code @}interface Something {}
 * </pre>
 * 
 * @param value indicates the provider that needs to be call
 * @param order indicates the order, in case of several annotations, in which
 * the interceptors (low value first) are called. If different interceptors
 * share the same order, then the order between them is undefined.
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface WithProvider {
  Class<? extends Provider> value();
  int order() default 0;
}
